PATHMac OS 8 and 9 Developer Documentation > Human Interface Toolbox > Window Manager >

Programming With the Mac OS 8.5 Window Manager

BasicWindowDescription

The BasicWindowDescription structure is a default collection item for a resource of type 'wind' . You use the BasicWindowDescription structure to describe the statically-sized base characteristics of a window.

struct BasicWindowDescription {
    UInt32                  descriptionSize;
    Rect                    windowContentRect;
    Rect                    windowZoomRect;
    UInt32                  windowRefCon;
    UInt32                  windowStateFlags;
    WindowPositionMethod    windowPositionMethod;
    UInt32                  windowDefinitionVersion;

    union {

        struct {
            SInt16              windowDefProc;
            Boolean             windowHasCloseBox;
        } versionOne;

        struct {
            WindowClass         windowClass;
            WindowAttributes    windowAttributes;
        } versionTwo;

    } windowDefinition;

};
typedef struct BasicWindowDescription BasicWindowDescription;

Field descriptions

descriptionSize
A value specifying the size of the entire BasicWindowDescription structure.
windowContentRect
A structure of type Rect , specifying the initial size and screen location of the window's content area.
windowZoomRect
Reserved.
windowRefCon
The window's reference value field, which is simply storage space available to your application for any purpose. The value contained in this field persists when the 'wind' resource is stored, so you should avoid saving pointers in this field, as they may become stale.
windowStateFlags
A 32-bit value whose bits you set to indicate the status of transient window states. See BasicWindowDescription State Constant for possible values.
windowPositionMethod
The specification last used in the function RepositionWindow to position this window, if any. See RepositionWindow Constants for a description of possible values for this field.
windowDefinitionVersion
The version of the window definition used for the window. Set this field to a value of 1 if your application is creating a pre-Mac OS 8.5 window, that is, a window lacking class and attribute information. Set this field to a value of 2 if your application is creating a window using class and attribute information. See BasicWindowDescription Version Constants for descriptions of these values.
windowDefinition
A union of the versionOne and versionTwo structures. Your application must either specify the window's class and attributes, or it must supply a window definition ID and specify whether or not the window has a close box. See Window Class Constants and Window Attribute Constants for descriptions of class and attribute values.
© 1999 Apple Computer, Inc. – (Last Updated 18 March 99)